home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / tsfltc16.zip / TSFLTC.INF < prev    next >
Text File  |  1994-02-12  |  8KB  |  231 lines
  1.                            - 1 -
  2. Sat 12-February-1994
  3.  
  4. About TSFLTC in General                         All rights reserved
  5. =======================
  6.  
  7. This package may be used and distributed freely for NON-COMMERCIAL,
  8. NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
  9. any way. (Repacking with another method is ok, though.) For ANY
  10. other usage, such as use in a business enterprise or a university,
  11. contact the author for registration. Uploading to bulletin boards is
  12. encouraged. Please do not distribute any part of this package
  13. separately.
  14.  
  15. The programs are under development. Comments and contacts are
  16. solicited. If you have any questions, please do not hesitate to use
  17. electronic mail for communication.
  18.  
  19. The author shall not be liable to the user for any direct, indirect
  20. or consequential loss arising from the use of, or inability to use,
  21. any program or file howsoever caused. No warranty is given that the
  22. programs will work under all circumstances.
  23.  
  24. Timo Salmi (ts@uwasa.fi)
  25. Professor of Accounting and Business Finance
  26. Faculty of Accounting & Industrial Management
  27. University of Vaasa
  28. P.O. BOX 297, FIN-65101 Vaasa, Finland
  29.  
  30.  
  31. Timo Salmi FiLTers set C, release 1.6 includes the following
  32. *    *     * **        *          * *
  33. filter-programs:
  34.  
  35. TSFLTC16        More textfile-filters, T.Salmi
  36. Filename        Comment
  37. --------        --------------------------------
  38. COL.EXE         Columnize a text file
  39. CONCAT.EXE      Join two text-files side by side
  40. CUT.EXE         Extract or delete text columns
  41. CUTW.EXE        Extract or delete text by words
  42. DETAB.EXE       Expand tabs properly into blanks
  43. DUMP.EXE        Decimal, hexadecimal, ascii dump
  44. FILE_ID.DIZ     Brief characterization of TSFLTC
  45. REP.EXE         Emphasize text file for printing
  46. ROT13.EXE       Rotate/unrotate text filter
  47. TSFLTC.INF      Document, a readme
  48. TSFLTC.NWS      News announcements about tsfltc
  49. TSPROG.INF      List of PD programs from T.Salmi
  50. UNDUMP.EXE      Convert decimals to ascii chars
  51. VAASA.INF       Info: Finland, Vaasa, U of Vaasa
  52. ----            ------             ------  -----
  53. 0014
  54.  
  55.  
  56.                            - 2 -
  57.  
  58. COL.EXE (Ver 1.0)  Columnize a text file
  59. =================
  60.  
  61. Usage: COL < InputFileName > OutputFileName
  62.  
  63. COL is a simple filter that extracts strings from the input file and
  64. outputs them as a single column.
  65.  
  66. Among other things COL can be used as a companion filter to UNDUMP
  67. which converts a series of decimal numbers into corresponding ascii
  68. characters. E.g. if you have the numbers in NUM.DAT with the
  69. following contents:
  70.  84 105 109 111 32 83 97 108 109 105 13 10
  71.  85 110 105 118 101 114 115 105 116 121 32 111 102 32
  72.  86 97 97 115 97 13 10
  73. then apply, for example TYPE NUM.DAT | COL | UNDUMP > NUM.BIN
  74.  
  75.  
  76. CONCAT (Ver. 1.0)  Join two text-files side by side
  77. =================
  78.  
  79. Usage: CONCAT FirstFile SecondFile [/bxx (number of blanks)]
  80.               [/fxx (first pad margin)] [/sxx (second pad margin)]
  81.          or
  82.        CONCAT [/h(elp)]
  83.  
  84. CONCAT is a program for concatenating two text files, that is
  85. joining them side by side. E.g. if you have texts OLD1.TXT and
  86. OLD2.TXT, and want to join them with 3 blanks in between, apply:
  87.  
  88.   CONCAT OLD1.TXT OLD2.TXT /b3 > NEW.TXT
  89.  
  90. You can pad with blanks the right margin of either of the text
  91. files. For this apply the /f switch and/or the /s switch. e.g.
  92.  
  93.   CONCAT OLD1.TXT OLD2.TXT /f40 > NEW.TXT
  94.  
  95.  
  96. CUT (Ver. 1.1)  Extract or delete text columns
  97. ==============
  98.  
  99. Usage:
  100. CUT StartColumn1 EndColumn1 [StartColumn2 EndColumn2] ... [/h] [/s]
  101.                                 Help (alternatively CUT ?) ─┘    │
  102.                                            Suppress empty lines ─┘
  103.  
  104. CUT is a true filter for extracting (or stripping) columns from a
  105. text file. E.g. if you have a text OLD.TXT, and want extract columns
  106. 7-20 from it, apply:
  107.  
  108.   TYPE OLD.TXT | CUT 7 20 > NEW.TXT
  109.  
  110. If you want to omit columns 7-20, then apply:
  111.  
  112.   TYPE OLD.TXT | CUT 1 6 21 255 > NEW.TXT
  113.  
  114. Alternatively, use faster CUT 1 6 21 255 < OLD.TXT > NEW.TXT
  115.  
  116.  
  117. CUTW (Ver. 1.0)  Extract or delete text by words
  118. ===============
  119.  
  120. CUTW StartWord1 EndWord1 [StartWord2 EndWord2] ... [/e] [/dxxx] [/h] [/s]
  121.                         relative to the End of line ─┘    │       │    │
  122.                                   additional Delimiters  ─┘       │    │
  123.                                       Help (alternatively CUTW ?)─┘    │
  124.                                                  Suppress empty lines ─┘
  125.  
  126. CUTW is a true filter for extracting (or stripping) words from a
  127. text file. E.g. if you have a text OLD.TXT, and want extract words
  128. 7-20 from it, apply:
  129.   TYPE OLD.TXT | CUTW 7 20 > NEW.TXT
  130.  
  131. If you want to omit words 7-20, then apply:
  132.   TYPE OLD.TXT | CUTW 1 6 21 255 > NEW.TXT
  133.  
  134. Alternatively, use faster CUTW 1 6 21 255 < OLD.TXT > NEW.TXT
  135.  
  136. All characters below ascii 33 are always considered word delimiters.
  137. You can introduce additional delimiters by using the /d switch.
  138.  
  139.  
  140. DETAB (Ver. 1.7)  Expand tabs properly into blanks
  141. ================
  142.  
  143. Usage: DETAB SourceFile DestinationFile [tab spacing]
  144. [/f(orce overwrites)] [/k(eep date)] [/m(ore)] [/n(o crt)] [/p(ause)]
  145.  
  146. Replaces tabs with a proper number of blanks. Applicable to text
  147. files. The default tab spacing is 8.
  148.  
  149. The switches in the brackets [] are optional. If you are working
  150. with a single disk drive, /p allows to change the disk by pausing
  151. after you have loaded DETAB. If you direct output to the screen
  152. (that is to CON) the /m option causes pause at the end of each
  153. screen. The /n option causes the program bypass the faster internal
  154. Crt routines. This option is included because these internal
  155. routines cause problems on PCs with poor compatibility. All the
  156. programs in this package are Turbo Pascal 5.0 programs, and Turbo
  157. Pascal code is meant for true compatibles.
  158.  
  159.  
  160. DUMP.EXE (Ver 1.0)  Decimal, hexadecimal, ascii dump
  161. ==================
  162.  
  163. Usage: DUMP [/a] [/h] [/nxxx] [/o] < InputFileName > OutputFileName
  164.               │    │    │       └─ omit the Offset information
  165.               │    │    └─ Number of columns (default 8)
  166.               │    └─ output in Hexadecimal instead of decimal
  167.               └─ omit Ascii dump
  168.  
  169. E.g. if you have a binary file NUM.BIN the appply, for example
  170.  
  171. DUMP < NUM.BIN > NUM.DAT
  172.  
  173.  
  174. REP (Ver. 1.0)  Emphasize text file for printing
  175. ==============
  176.  
  177. Usage:
  178. REP [NumberOfRepeats] [/m##] [/s##] [/e##] < InputFileName > OutputFileName
  179.             │           │      │      │           │
  180.  default 3 ─┘           │      │      │           │
  181.            left margin ─┘      │      │           │
  182.        starting preamble code ─┘      │           │
  183.                ending postamble code ─┘           │
  184.                                 normally use PRN ─┘
  185.  
  186. or TYPE InputFileName | REP [parameter] [switches] > OutputFileName
  187.  
  188. The purpose of this filter is to improve the quality of text sent to
  189. the printer by repeating each line the desired number of times.
  190.  
  191. Examples:
  192.  REP < YourTextFile > PRN
  193.  REP 2 /m9 /s!$ /e@ < YourTextFile > PRN
  194. The escapes are implicit in /s and /e, so e.g. /e@ sends <esc>@
  195. which is the reset code for Epson compatible printers.
  196.  
  197.  
  198. ROT13 (ver 1.0)  Rotate/unrotate text filter
  199. ===============
  200.  
  201. ROT13 rotates ascii text by 13 positions. This is often used as an
  202. elementary encryption technique for public but somehow sensitive
  203. texts.
  204.  
  205. E.g. if you have a rotated text file ROTA.TXT, apply
  206. TYPE ROTA.TXT | ROT13 > NORM.TXT
  207.    or
  208. ROT13 < ROTA.TXT
  209.    or
  210. ROT13 < ROTA.TXT > NORM.TXT
  211.  
  212. ROT13 works both ways.  It rotates unrotated text and unrotates
  213. rotated text.
  214.  
  215.  
  216. UNDUMP.EXE (ver 1.0)  Convert decimals to ascii chars
  217. ====================
  218.  
  219. Usage: UNDUMP [/h] < InputFileName > OutputFileName
  220.                 └─ input in Hexadecimal instead of decimal
  221.  
  222. UNDUMP converts a series of decimal numbers into corresponding ascii
  223. characters.
  224.  
  225. E.g. if you have the numbers in NUM.DAT with the following contents:
  226.  84
  227.  105
  228.  109
  229.  111
  230. then apply, for example UNDUMP < NUM.DAT > NUM.BIN
  231.